.\"
.\" Copyright (c) 2012-2017 Apple Inc. All rights reserved.
.\"
.\" Licensed under the Apache License, Version 2.0 (the "License");
.\" you may not use this file except in compliance with the License.
.\" You may obtain a copy of the License at
.\"
.\"     http://www.apache.org/licenses/LICENSE-2.0
.\"
.\" Unless required by applicable law or agreed to in writing, software
.\" distributed under the License is distributed on an "AS IS" BASIS,
.\" WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
.\" See the License for the specific language governing permissions and
.\" limitations under the License.
.\"
.\" The following requests are required for all man pages.
.Dd Feb 3, 2011
.Dt CALENDARSERVER_MONITOR_NOTIFICATIONS 8
.Os
.Sh NAME
.Nm calendarserver_monitor_notifications
.Nd Calendar Server push notification monitor
.Sh SYNOPSIS
.Nm
.Op Fl -admin Ar username
.Op Fl -config Ar file
.Op Fl -host Ar hostname
.Op Fl -node Ar pubsub-node-name
.Op Fl -port Ar port-number
.Op Fl -ssl
.Op Fl -verbose
.Op Fl -help
.Ar username
.Sh DESCRIPTION
.Nm
is a tool for making sure XMPP push notifications are working
properly.  Given a username and password it will connect to the
calendar server and determine which pubsub node(s) correspond to that
user's calendar home, as well as those of any user which has delegated
calendar access.  Next it will subscribe to those nodes and await
notifications, printing them to stdout.  An administrator can monitor
the push notifications for another user by passing the --admin option.
Exit by hitting Control-C.
.Pp
.Sh OPTIONS
.Bl -tag -width flag
.It Fl a, -admin
Authenticate using the credentials of the given administrator.
.It Fl h, -help
Display usage information.
.It Fl f, -config Ar FILE
Use the Calendar Server configuration specified in the given file.
Defaults to /etc/caldavd/caldavd.plist.
.It Fl H, -host Ar HOSTNAME
Connect to the specified calendar server.  If not passed on the
command line, the host name is looked up in the configuration file.
.It Fl n, -node Ar NODENAME
Bypass the auto-discovery of pubsub nodes and specify one explicitly.
Useful on calendar servers which don't support the push-transports DAV
property.  When using this option, the host and port options instead
refer to the XMPP server host and port numbers.
.It Fl p, -port Ar NUMBER
Connect to the specified port number.  If not passed on the command
line, the port number is looked up in the configuration file.
.It Fl s, -ssl
Use https to connect to calendar server (default is http).
.It Fl v, -verbose
Print debugging information.
.El
.Sh FILES
.Bl -tag -width flag
.It /etc/caldavd/caldavd.plist
The Calendar Server configuration file.
.El
.Sh SEE ALSO
.Xr caldavd 8
